Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrOpenDoc

QuickDraw GX sends the GXPrOpenDoc message when an application that supports the Macintosh Printing Manager calls the PrOpenDoc function. You can override the GXPrOpenDoc message to customize the handling of the PrOpenDoc function. Your override of the GXPrOpenDoc message must match the following formal declaration:

OSErr MyPrOpenDoc (THPrint aTHPrint, TPPrPort *aTPPrPort);

aTHPrint

A handle to the print record for this printing operation.

aTPPrPort

A pointer to a TPrPort record.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrOpenDoc sends the GXStartJob message. You can override the GXPrOpenDoc message to add any special handling that your printer driver requires at the time that a document is spooled for printing.

SPECIAL CONSIDERATIONS

You never send the GXPrOpenDoc message yourself.

You almost always forward the GXPrOpenDoc message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrOpenDoc function is described in Inside Macintosh: Imaging With QuickDraw.

The GXStartJob message is described on page 4-52.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help